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PATENT 

IN THE UNITED STATES PATENT AND TRADEMARK OFFICE 

Applicants: Mark J. Flanagan AttyDktNo.: 2001P18375US 

Serial No.: 09/742,696 Examiner: T.J.ROCHE 

Filed: January 9, 2002 Art Unit: 2124 
For INTERACTIVE COLLABORATIVE 

FACILITY FOR INSPECTION AND 

REVIEW OF SOFTWARE PRODUCTS. . . 

DECLARATION UNDER 37 C.F.R. S1.131 

Mail Stop AMENDMENT 
Conmussioner for Patents 
P.O. Box 1450 
Alexandria, VA 22313-1450 



I hereby certify that this Coirespondence is being deposited with the United States Postal 
service with sufficient postage for first class mail in an envelope address to the 
Commissioner for Patents, P.O. Box 1450. Alexandria, VA 22313-1450, on: 
Date of Deposit: Sept 13^ 200S 

Typed Name: Frmda G. Montgomery . 

Signature: _ 



Sir: 

I, Mark J. Flanagan, inventor for the invention claimed in the above referenced patent 
application, declare as follows: 

Sometime prior to December 1, 2001, 1 conceived and reduced to practice: 

a review facility for providing an item, such as a document (e.g., source code), for review by a 

plurality of reviewers, e.g., in a development group, and collecting comments fix>m reviewers, 

a method of reviewing items in the review facility, 

and a program product embodying the review facility; 
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My review facility included: 

preparation means for preparing an item for interactive review, 

means for collecting comments on elements (e.g., lines in the document) of prepared items; and 
means for distributing collected comments bom review; 

The review facility also included means for making prepared items available for interactive 
collaborative review; 

The review facility identifies individual elements within an item with reviewers providing 
comments on individual elements; 

Particular individual elements may be block of text, e.g., individual lines of said source code; 

Sometime prior to December 1, 2001, my invention was reduced to practice and memorialized in 
an MSWord file, a hardcopy of which is attached hereto and marked Exhibit A; 

Sometime prior to December 1, 2001, 1 printed flie contents of the MSWord file and submitted it 
as Siemens Corporation Invention Disclosure, a copy of the cover page, the first and last pages of 
which are attached hereto, the conception date and personal information having been redacted as 
indicated and marked Exhibit B; 

On January 9, 2002, the present patent application was filed embodying my invention; 

All acts, including conception and reduction to practice, occurred in the United States; 

I further declare that all statements made herein of my own knowledge are true and that all 
statements made on information and belief are believed to be true; and 
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I further declare that these statements were made with the knowledge that willful false statements 
and the like so made are punishable by fine or imprisonment, or both, under Section 1001 of 
Title 18 of the United States Code, and that such willfiil false statements may jeopardize the 
validity of the application or any patent issued thereon. 

Inventor: Mark J. Flanagan 



Signature: 






Date 



Residence: 



8735 Indian River Run 
Boynton Beach, FL 33437 



Citizenship: U.S. 

Post Office Address: Same as above 
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Invention Dtsdosnire Foim Supplement 



1. Title : 



WebReview 



2. Abstract: 

WebReview provides for inspection and review of software products (source code) 
using a collaborative, interactive facility. 



3. Background Information 

a. What is the orobliem solved bv vour invention? 

Code Inspections are an integral part of our software development processes. 
Currently, a static packet is created by the author or moderator assigned to the 
review which is distributed to all reviewers. After a suitable review period, a 
meeting is held where an assigned developer reads the code out loud and 
reviewers make comments and identify errors or problems. These are recorded by 
the assigned moderator and corrected by the author, completing the review 
process. 

What techniques prior to vour invention were used t o perform the function of 
vour invention ? 

1) Manual inspections generally on paper, in accordance with software 
developinent i>rocess guidelines. 



c. What are the disadvantages of these prior techniques? 

The review/inspection meeting(s) generally take a great deal of time, current 
inspection guidelines use a metric of 100-125 lines of code per hour of meeting 
witii similar times required for preparation and correction times. 



C>n-line review, with collaborative collection of information should be much more 
efficient. Reviewers receive information from each other during the preparation 
process so the review meeting should be much shorter. Since the comments are 
available immediately, the author and moderator can agree on the clarity and 
correctness of most conunents and eliminate the need for discussion. 



2) 



What are the advantages of vour invention over the prior techniques? 



Witness: 



Date: 
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4. Detailed Description 

a. Detailed structural and fbnctianal operation : 
This process consists of three operations: 

1. Preparing the WebReview for the item under consideration. This involves 
formatting the item to be inspected with unique identification of each element 
(i.e. source code lineX gathering the elements of the item (i.e. source files) 
into a known location, and constructing the initially-empty collected 
comments. 

2. Inspecting or reviewing the itein Uiide^ consideratioti. This involves two 
classes of activities: 

a. The collaborators eKamine^ in detail^ tiie item using the WebReview 
server and individual equipment (e.g. a web-browser). As comments, 
questions, and errors are noted by individuals, they provide their 
remarks to the WebRevi^iw server. These comments are then made 
available to all other collaborators, identified by the inspector and the 
item (e.g. source code file and line number) where they apply. 

b. The WebReview server provides the collaborators with the prepared 
elements pf the item and accepts remarks from individuals. The 
remaiics are gathered and provided to any collaborator on demand. 

3. Executing the formal review nieeting using products of the WebReview 
process. This uses the collective remarks entered during the review by all 
collaborators. The author and moderator will generally agree that some 
(usually most) of the remarks are clear and obvious and do not require 
additional information. Usually, a few remaiks remain and a (brief) meeting 
among the collaborators is used to clarify and discuss the specific areas of 
concern. 

b. Are there alternative methods or different structural embodiments of vour 
invention? Can the general idea or technique of vour invention be extended to 
other related fields? How? 

Any collaborative facility could be employed in various means to execute a 
WebReview-like process. The advantages of WebReview are the centralized 
collection of information as it is generated to guide the collaboration and the 
persistence of information. 



Witness: 



Date: 
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Similar current practices for document review involves distributing a "master 
copy** of a document which is then individually annotated and returned to the 
distributor. Tlie distributor then collects the comments into a new version of the 
''master document*' and may redistribute the new version for iterative review 
preparation. The advantages of the WebRieview concept are the immediate 
availability of other's comments and Ifae automation of the comment gathering and 
organization. 

The general collaborative facility could be applied to any suitable item to be 
collectively inspected or reviewed by a groups The advantage of providing group 
comments during the individual preparation process is applicable to more than 
simply source code inspections. Any document which can.be fully described 
using network facilities could be reviewed/iiispected using similar faciiitidi^ to the 
preferred mibodiment given. 

c. Which features are believed to be new? 

The application of network-based information gathering and dissemination to the 
formal, structured process of inspection of source code is not knoyifn to be applied 
at this time. 

d. Set forth the preferred embodiment for vour invention. 

There are two elements to the preferred embodiment of WebReview at this time. 

1 . The preparation facilities accept a collection of source code and generates 
formatted HTML pages with line numbers linked to a comment entry form. 
Also prepared is a table of contents for the entire source code file collection. 

2. The collaboration facility consists of a Perl program executing as a CGI 
(Common Gateway Interface) extension to the Apache web server. As 
collaborators enter their comments into the remark entry form» the CGI data is 
passed to the Perl prog;ram which validates the form of information and 
records the remarks in the central review data store. Anotiier element of the 
same CGI program provides for retrieval of previously stored information^ 
possibly restricted to a particular file or set of files (inspection elements), a 
particular user's comments, both restrictions together, or all stored information 
at the collaborator's discretion. Each entered remark is hyper-linked to the 
specific item (prepared file and line number) to which it applies. 



Witness: 



Date: 
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1. Title : WebRevicw 

2. Abstract : 



WebRcview provides for inspection and review of software products (source code) 
using a collaborative, interactive facility. 



3. Background Information 

a. What is the problem j aftlva^ bv voar invention? 

Co<k» inspections are an integral part of our software development processes. 
CuxTcnUy, a static packet is created by the author mocterator assigned to the 
review which is distributed to all reviewers. After a suitable review period, a 
meeting is held where an assigned developer reads the code out loud and 
mvicweis make comments and identify mors w jnoblems. These are recorded by 
the assigned moderator and conected by the author, completing the review 
process. 

b. What lechnioues pri o r to vour invention wiirfc used to perfom the function of YQUr 

inygfitioti? 

1) Manual inspections generally on paper* in accordance with software 
ck^velopment process guidelines. 

c. What are th y jf^Ht/yitages of these Prior tffchnfancs? 

The review/inspection meeting(s) generally take a gmat deal of time, current 
inspection guidelines use a naetric of 100-125 lines of code per hour of meeting 
with similar ttmiss required for preparation and correction times. 

d. What are tfij ff f^^^^^^K^ of votir invention over the prior techniques? 

On-line review, with collaborative collection of information should be mtich more 
efficient. Reviewers receive information fVom each other during the preparadon 
process so the review meeting should be much shorter. Since the comments are 
available immediately, the author and moderator can agree on the clarity and 
correctness of most comments and eliminate the need for discussion. 




Pare: f I J PL 
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Simitar current practices for document review involves distributing a ''master 
copy" of a document which is then individually annotated and tetumisd to the 
distributor. The distribute then collects the comments into a new version of the 
"master document'* and may redistribute the new version for iterative review 
preparation. The advantagjes of the Wel>Review concept are the immediate 
availability of otherlt comments and the automation of the comment gathering and 
organizati<m. 

The general collaborative facility could be applied to any suitable item to be 
collecdvely inspected or reviewed by a group. The advantage of providing group 
comments during the individual preparation pr o ces s is applicable to more than 
simply source code inspections. Any document which can be f\il1y des^bed using 
network facilities could be reviewed/lnspeeted using similar facilities to the 
prcfenned embodiment given. 

c. Which feat ures are befiatved to be new? 

The education of network^»ased information gathering and dissemination to the 
formal* structured process of inspectitm of source code is not known to be applied 
at this time. 

d. Set forth the mefenred embodiment for vour invendon. 

Thete ate two elements to the picfet i ed embodiment of WebReview at this dme. 

1. The preparadon facilities accept a collection of source code and generates 
formatted HTML pages wid» line numbers linked to a conmient entry form- 
Also i w epju ed is a table of contenu far the entire source code file collMdon. 

2. The collaboration facility consists of a Ferl program executing as a COX 
(Common Gateway Interface) extension to the Apache web server. As 
collaborators enter their conmxents into the remsrk entry form, the CQI data is 
passed to the Pserl pi og^ ai n which validates the form of infocmatim and 
records the remarks in the central review data stme. Anodier element of the 
same COI program provides for retrieval of previously stoned information, 
possibly restricted to a particular file or set of files (inspection elements), a 
particular uscrii comments, both restrictions together, or all stored information 
at the collaborator^ discretion. Bach entered remark is hyper->linked to the 
specific item (pmpared file and line ntimber) to which it applies. 



Witness; 
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